Each time a set of matching transactions are located and retrieved, the ARCRET utility calls the plug-in functions to process those transactions. By default the ARCRET utility searches until a single matching transaction is found, retrieves the associated form set, and then calls the plug-ins. Therefore, the default set size is one transaction.
For some plug-in functions, a larger set size will improve performance—especially if the plug-in has excessive startup or shutdown time requirements. Use the /S parameter to designate the number of rows/records to include in a set before the ARCRET utility calls the plug-in functions.
Note | If there are not enough matching transactions found in the index file, the plug-ins are called with however many matching transactions were found. If you create a plug-in, keep in mind the plug-in should make no assumptions about the number of transactions in the sets. |
You can also use the /P parameter with sets. This parameter tells the utility to pause as each set is processed and wait until you press Enter before building the next set. This parameter is useful if you need to examine or copy the output files produced by the plug-ins before starting the next set.
© Copyright 2013, Oracle and/or its affiliates. All rights reserved. Legal notices.